Skip to main content
POST
Send a probe bid request to an ad source

Authorizations

Authorization
string
header
required

Bearer authentication. Pass the access token in the Authorization: Bearer <token> header.

Body

application/json

POST /allocations/bid-request-probes request body.

ad_source_id
string<uuid>
required

Ad source to send the test bid request to

allocation_ext
AllocationExt · object
required

Allocation ext under test

environment
enum<string>
required

Environment to test — web or app

Available options:
web,
app
platform
enum<string>
required

Device platform to test. It picks the User-Agent and device.os sent to the vendor in both environments, and for app it also picks which bundle (ios_bundle or android_bundle) is sent.

Available options:
ios,
android
tid
string<uuid>
required

Target ID

ttype
enum<string>
required

Target type — only ad_unit is supported

Available options:
ad_unit,
placement

Response

Successful Response

The bid request sent to the ad source and the resulting response.

Ad-source HTTP 4xx and 5xx responses are returned as probe results with HTTP 200; the ad source's status is available in status_code.

bid_request
Bid Request · object
required

BidRequest body that was sent

elapsed_ms
integer
required

Round-trip time in milliseconds, including DNS, TCP and TLS setup. Not comparable to the edge server's read timeout, which is applied to the read stage alone over a pooled connection.

body
string | null

Raw response body from the ad source, capped at 16000 bytes while reading — a body longer than that is cut off mid-download

error
string | null

Transport-level failure as ExceptionClass: message — the class name separates a connect timeout from a read timeout, which share the same message

status_code
integer | null

HTTP status returned by the ad source — null if unreachable